Inside Macintosh: Telephony /

Chapter 3 - Directory Numbers / Directory Number Reference

Constants

Directory Number Feature Flags

The directory number structure (TELDNRecord (page 3-12)) contains, in the featureFlags field, a set of bit flags indicating the relationship between certain features and a particular directory number. A given feature can be subscribed, available, or active.

The names of the feature flags are typically xxxSub, xxxAvail, and xxxActive, where xxx is the name of the feature. For instance, the flags dndSub, dndAvail, and dndActive indicate whether the Do Not Disturb feature is subscribed, whether it is available, and whether it is active.

To specify the features of a given directory number, the Telephone Manager defines the TELDNFeatureFlags data type, as follows:

typedef unsigned long      TELDNFeatureFlags;

All unused bits in the featureFlags field are reserved.

enum {
   dndSub                  = 1L << 0,
   dndAvail                = 1L << 1,
   dndActive               = 1L << 2,
   voiceMailAccessSub      = 1L << 3,
   voiceMailAccessAvail    = 1L << 4,
   voiceMailAccessActive   = 1L << 5,
   pagingSub               = 1L << 6,
   pagingAvail             = 1L << 7,
   pagingActive            = 1L << 8,
   intercomSub             = 1L << 9,
   intercomAvail           = 1L << 10,
   intercomActive          = 1L << 11,
   dnSelectSub             = 1L << 12,
   dnSelectAvail           = 1L << 13,
   dnSelectActive          = 1L << 14,
   callPickupSub           = 1L << 15,
   callPickupAvail         = 1L << 16,
   dnInUse                 = 1L << 17,
   logicalDN               = 1L << 18,
   dnAccessible            = 1L << 19,
   canInitiate             = 1L << 20,
   voiceMessageWaiting     = 1L << 21,
   hasDNSoundStreams       = 1L << 22,
   autoAnswerAvail         = 1L << 23,
   autoAnswerActive        = 1L << 24,
   tollSaverAvail          = 1L << 25,
   tollSaverActive         = 1L << 26
};

Constant descriptions

dndSub

If this bit is set, the Do Not Disturb feature is subscribed.

dndAvail

If this bit is set, the Do Not Disturb feature is available.

dndActive

If this bit is set, the Do Not Disturb feature is active.

voiceMailAccessSub

If this bit is set, the Message Waiting feature is subscribed.

voiceMailAccessAvail

If this bit is set, the Message Waiting feature is available.

voiceMailAccessActive

If this bit is set, the Message Waiting feature is active.

pagingSub

If this bit is set, the Paging feature is subscribed.

pagingAvail

If this bit is set, the Paging feature is available.

pagingActive

If this bit is set, the Paging feature is active.

intercomSub

If this bit is set, the Intercom feature is subscribed.

intercomAvail

If this bit is set, the Intercom feature is available.

intercomActive

If this bit is set, the Intercom feature is active.

dnSelectSub

If this bit is set, the Directory Number Select feature is subscribed.

dnSelectAvail

If this bit is set, the Directory Number Select feature is available.

dnSelectActive

If this bit is set, the Directory Number Select feature is active.

callPickupSub

If this bit is set, the Call Pickup feature is subscribed.

callPickupAvail

If this bit is set, the Call Pickup feature is available.

dnInUse

If this bit is set, the directory number is in use (a call appearance is allocated for this directory number).

logicalDN

If this bit is set, this directory number is a logical directory number (no corresponding physical channel is connected to the terminal).

dnAccessible

If this bit is set, commands can be sent to this directory number.

canInitiate

If this bit is set, this directory number can initiate outgoing call appearances.

voiceMessageWaiting

If this bit is set, there is voice-mail waiting for this directory number.

hasDNSoundStreams

If this bit is set, sound streams are supported for this directory number (the directory number supports a sound input driver and a sound output component). Note that the pcmAvail bit is set in the telephone terminal record's featureFlags field whenever hasDNSoundStreams is set.

autoAnswerAvail

If this bit is set, Auto-answer is available for this directory number. Incoming calls are routed to a client application that has requested such routing.

autoAnswerActive

If this bit is set, Auto-answer is currently applied to a call appearance on this directory number (that is, the call was answered on the ring specified by the auto-answer ring count).

tollSaverAvail

If this bit is set, the Call Saver feature is available for this directory number. Incoming calls can be answered after fewer rings than normal if messages are pending.

tollSaverActive

If this bit is set, the Call Saver feature is currently applied to a call appearance on this directory number (that is, the call was answered on the ring specified by the call saver ring count).